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Preface 


This book provides information for persons installing VS Pascal under Virtual 
Machine/System Product (VM/SP) or Virtual Machine/Extended Architecture 
(VM/XA). This book contains no definition of the VS Pascal programming language 
and its syntax. For information about this subject matter, see VS Pascal Language 
Reference. 


Along with this manual, consult the Program Directory shipped with VS Pascal, 
which may contain updates to this book. 


VS Pascal also runs under Multiple Virtual Storage/System Product (MVS/SP), 
Multiple Virtual Storage/Extended Architecture (MVS/XA), and Multiple Virtual 
Storage/Enterprise Systems Architecture (MVS/ESA). For information on installing 
VS Pascal under MVS/SP, MVS/XA, or MVS/ESA, see VS Pascal Installation and 
Customization Guide for MVS, SC26-4321-1. 


Prerequisite Knowledge 


This book is for system programmers and/or system administrators who are 
responsible for installing and maintaining VS Pascal under CMS. It assumes you 
are familiar with VM, Conversational Monitor System (CMS), and that you have a 
general knowledge of the structure and function of VS Pascal. 


How This Book is Organized 


This book is organized into the following chapters: 


Chapter 1, “What You Need to Install VS Pascal” details requirements for VS 
Pascal installation. 


Chapter 2, “Planning to Install and Customize VS Pascal” describes the 
decisions you must make before beginning to install and customize VS Pascal. 


Chapter 3, “Installing VS Pascal under VM” describes how to install VS Pascal 
under VM. 


Chapter 4, “Customizing VS Pascal after Installation” describes how to 
customize VS Pascal after installation, and how to run the installation 
verification procedure separately. 


Chapter 5, “Installing and Customizing VS Pascal under VM/IS” describes 
how to install VS Pascal under Virtual Machine/Integrated System. 


Appendix A, “Summary of Changes” summarizes the additions and 
enhancements VS Pascal Release 2 makes to VS Pascal Release 1. 


Appendix B, “Installation Messages” describes the installation messages and 
installation verification procedure messages. 


Appendix C, “Servicing VS Pascal” explains how to install the program 
service available for VS Pascal. 


The “Bibliography” lists the VS Pascal publications and other relevant 
publications. 
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Chapter 1. What You Need to Install VS Pascal 


Hardware 


This chapter discusses the hardware and software required to install and execute 
VS Pascal. It also lists the contents of the IBM Software Distribution (ISD) tape. In 
addition to the information provided here, be sure to read the Program Directory 
shipped with the VS Pascal product. The Program Directory describes all the 
installation materials and provides any additional instructions you need due to the 
product release and modification level. 


VS Pascal runs on any processing unit supported by VM. 


Operating System 


Virtual Storage 


Tape Drive 


VS Pascal and its generated object programs run under these operating systems: 


¢ Virtual Machine/System Product (VM/SP) Version 1, Release 4 or later, with or 
without the High Performance Option (HPO). 


Note: Use of VS Pascal’s Double-Byte Character Set (DBCS) support requires 
VM/SP Version 1, Release 5 or later. 


e Virtual Machine/Extended Architecture (VM/XA), Release 1 or later. 


Note: Under CMS, VS Pascal and its generated programs require the OS 
simulation facility. 


Under CMS, VS Pascal requires a minimum of 1 megabyte to compile a program. 
Complex programs may require more storage. The 1-megabyte storage is 
sufficient to compile both sample programs supplied with the IBM Software 
Distribution (ISD) tape. 


To run a minimum compiled program, you need an 864-kilobyte CMS machine. 


To install VS Pascal, you need a magnetic tape drive compatible with the IBM 
Software Distribution (ISD) tape. 
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Disk Storage 


You need a production minidisk to install VS Pascal and run the installation 
verification procedure (IVP). The production minidisk is used to run VS Pascal and 
is linked to by all VS Pascal users. It contains the production libraries installed 
from the ISD tape. If you have Pascal/VS or VS Pascal Release 1, use a different 
production disk for VS Pascal Release 2. 


When installing, customizing, and servicing VS Pascal, you also need an unused 
device address in the range of 210 to 280, where a temporary minidisk is created. 


See the Program Directory for the DASD sizes of the production and temporary 
minidisks. 


The IBM Software Distribution (ISD) Tape 


The various files on the ISD tape for the VS Pascal Compiler and Library product 
(5668-767) contain: 


e Product identifier file and installation EXEC 
¢ Memo to Users 


e VS Pascal compiler modules; run-time and debugging TXTLIBs; product 
LOADLIBs; product MACLIB; compile, link-edit and execute EXECs; EXEC 
HELP files; and product message files 


e Installation verification EXEC and sample programs 


e Necessary files for service and customization. 


The various files of the ISD tape for the VS Pascal Library product (5668-717) 
contain: 


¢ Product identifier file and installation EXEC 
¢ Memo to Users 


e VS Pascal run-time TXTLIB; product LOADLIBs, link-edit and execute EXECs; 
EXEC HELP files; and product messages files 


e Installation verification EXEC and compiled sample programs 


¢ Necessary files for service and customization. 
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Chapter 2. Planning to Install and Customize VS Pascal 


| VS Pascal is available as two separate products. VS Pascal Compiler and Library 
| (5668-767) is the complete licensed program containing the compiler, run-time 
| library, and the debugging library. VS Pascal Library (5668-717) contains only the 
| run-time library. This book contains installation instructions for both products. 


| Each licensed program is distributed as a single tape containing the necessary 
| modules. 


Installation is the process of adding the materials on the IBM Software Distribution 
(ISD) tape to your system. This process produces a fully operational VS Pascal 
product. 


| Customization is an optional process. It gives you the opportunity to change these 
| operational features: 


| e The format used for dates 

| e The default language for generated text 

| e The uppercase and character translation tables 

| e Where in storage the VS Pascal compiler resides. 


Where to Find More Installation Information 


For specific information on space allocations and other details, see the Program 
Directory shipped with the ISD tape for VS Pascal. The Program Directory 
describes all the installation materials and gives installation instructions specific to 
the product release and modification level. 


The DATETIME Procedure 


During installation, you customize the VS Pascal DATETIME procedure to return 
the current date as day/month/year (European format) or month/day/year (U.S. 
format). The IBM-supplied default is the U.S. format. 


You can also customize the DATETIME procedure after installation. For more 
information, see “Customizing the DATETIME Procedure after Installation” on 
page 11. For more information on the DATETIME procedure, see VS Pascal 
Language Reference. 


. The Default Language 


| The default language determines what language the compiler and run-time 
| environment uses for error messages and other generated text. 


| VS Pascal provides National Language Support (NLS) for uppercase and 

| mixed-case English and for Japanese. As shipped, uppercase English is the 

| default language. During installation, you select a default language from the list of 
| languages shipped with the product. The default remains uppercase English 

| unless you specify another language. 
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The available languages are: 


e Mixed-case English 
e Uppercase English 
e Japanese. 


The message modules for the selected language are link-edited with the product. 


At compile time and run time, you can select a language other than the default 
language by using the LANGUAGE option. VS Pascal loads this new language 
without affecting the default language. 


You can also customize the default language after installation. For more 
information, see “Customizing the Default Language after Installation” on page 13. 


The Uppercase and Character Translation Tables 


You can customize the uppercase and character translation tables of the VS Pascal 
Compiler and Library product (5668-767). 


Note: This customization applies only to the VS Pascal Compiler and Library only 
product (5668-767). 


You customize these tables to allow for different national character coding 
standards, or to support devices equipped with characters different than those 
shipped with VS Pascal. 


Note: To customize the uppercase and character translation tables, you must first 
install VS Pascal normally. You then rerun the installation EXEC, specifying 
uppercase and character translation table customization. See “Customizing the 
Jppercase and Character Translation Tables after Installation” on page 15 for 
details. 


Extended Architecture (XA) 


You can install VS Pascal for use in Virtual Machine/Extended Architecture 
(VM/XA) systems. The compiler can be installed above or below the the 
16-megabyte line. Installing above the 16-megabyte line relieves some of the 
crowding in the 24-bit address space. However, VS Pascal runs slightly faster 
below the line. The IBM-supplied default is below the 16-megabyte line. The 
default remains in effect unless you specify otherwise. 


Note: The XA option applies only to the VS Pascal Compiler and Library product 
(5668-767). 


You can also change the XA option after installation. For more information, see 
“Customizing the XA Option after Installation” on page 21. 
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Chapter 3. Installing VS Pascal under VM 


This chapter describes the installation process, and the installation steps. Read 
the entire chapter before attempting installation. 


The Installation Process 


The installation program you will use to install VS Pascal is an IBM-supplied EXEC 
that is on the IBM Software Distribution (ISD) tape. The EXEC prompts you for 
responses that control the installation process and copies the files that you need 
onto the production minidisk. 


The installation steps for the VS Pascal Compiler and Library product (5668-767) 
are almost identical to the installation steps for the VS Pascal Library product 
(5668-717). When you must do something differently, depending on the product you 
are installing, the installation EXEC indicates your choices. 


The following features simplify VS Pascal installation. 


e The product tape contains pregenerated, executable modules. Installation is 


faster because you need not link-edit all the object decks. 


The installation EXEC automatically invokes the installation verification 
procedure (IVP) after installation is complete. 


The installation EXEC stores your responses to prompts in a configuration file. 
The installation EXEC “remembers” your responses to prompts, thus saving 
time if you need to re-run the installation EXEC to service or customize the 
product. 


The Installation Steps 
Install VS Pascal by: 


iP 


Loading the tape 


2. Installing VS Pascal 
3. Verifying the output. 


Step 1: Loading the Tape 


To load the ISD tape, perform the following steps: 


1. 
2. 


Attach the tape drive containing the VS Pascal ISD tape to virtual address 181. 


Link the VS Pascal production minidisk in READ/WRITE mode and access it 
with a filemode other than A. 


Issue the command: 
VMFPLC2 LOAD * * filemode 


where filemode is the filemode of the production minidisk. This loads the 
installation EXEC onto the production minidisk. 


Note: Do not remove or rewind the tape at this time. 
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| 
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Step 2: Installing VS Pascal 
This step invokes the installation EXEC, which performs the actual installation. 
The installation EXEC will prompt you to enter responses based upon the product 
you are installing, and how you want to configure the product. 


Perform the following steps: 


1. To install the VS Pascal Compiler and Library product (5668-767), issue the 
command: 


15668767 


To install the VS Pascal Library product (5668-717), issue the command: 
15668717 


2. Enter a “1” or “YES” to begin installation, or “O” or “NO” to quit. 


Note: To stop the installation process, respond to any prompt with “QUIT”. If 
you need to see the informational message again before answering the input 
prompt, enter “?” to review the material. 


3. To use the displayed linkage information, (user ID, minidisk address, and 
READ/WRITE password of the production minidisk) enter a “0”, “NO”, or press 
the ENTER key without specifying a value. 


To change the displayed user ID, minidisk address, or the production minidisk 
password, enter “1” or “YES”, and change the appropriate values. 


If you are not the owner of (or are not linked to) the production minidisk, you 
can force a logoff of the user ID that owns the production minidisk. If you enter 
“1” or “YES”, the installation EXEC forces off that user ID (if it is currently 
running disconnected in the system). 


Note: If your user ID is not authorized to force a logoff, you will receive an 
error message. 


4. Select a date format. As shipped, the default is the U.S. format. Keep the U.S. 
date format by entering “1”, “U”, “US”, or by pressing the ENTER key without 
specifying a value. 


To change the date format to the European format enter “2”, “EUROPEAN”, or 
an abbreviation such as “E”. 


5. Select a default language. As shipped, the default language for VS Pascal is 
uppercase English. If you do not choose another language, uppercase English 
remains the default. 


To select another default language, you must enter either a numeric ora 
three-character identifier: 


Enter For Language 

1 or UEN Uppercase English 
2 or ENG Mixed-case English 
3 or JPN Japanese 


To accept the IBM-supplied default, press ENTER without specifying an 
identifier. 


6 VS Pascal Installation and Customization Guide for VM 


6. The installation EXEC asks if you want to install the VS Pascal compiler above 
the 16-megabyte line. 


Note: This option is available for VM/XA (Virtual Machine/Extended 
Architecture) systems only. 


To install the VS Pascal compiler above the 16-megabyte line, enter a “1” or 
“YES”. To install the VS Pascal compiler below the 16-megabyte line, enter a 
“0” or “NO”, or press ENTER without specifying a new value. 


Note: If you have full screen mode set on, the installation EXEC temporarily 
suspends full screen mode while executing. Full screen mode is set back on 
when the installation EXEC has completed. This is done to allow informational 
messages to be displayed on a timely basis. 


Any error messages you get during the installation procedure are listed in 
Appendix B, “Installation Messages” on page 33. 


Note: The ISD tape contains some TEXT files that are not required to use the 
product but are required for service and customizing. The installation EXEC loads 
these files with a file mode of fm1, where fm is the file mode character used to 
access the production minidisk. The installation EXEC loads the files needed to 
compile, link, and execute VS Pascal programs with a file mode of fm2. You can 
improve access time by accessing the production minidisk with the command: 


ACCESS cuu fm/A * * fm2 


where fm is the file mode you used to access the production minidisk and cuu is 
the virtual address of your production minidisk. This allows only the files needed 
to run the compiler to be included in the CMS resident directory. 


Figure 10n page 8 shows the output from installing the VS Pascal Compiler and 
Library product (5668-767). The output from installing the VS Pascal Library 
product (5668-717) is almost identical to Figure 1, and the differences are listed in 
the notes following Figure 1. The lines beginning with ===> indicate what you 
entered. 
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===> [5668767 (note 1) 

Ee 15668767 - VS Pascal (note 2) 

nee Version 1 Release 2 Modification 0 

sad Do you wish to install this product now? 

wk Enter 1 (YES) or © (NO). 

s=c=> 1 

*** Begin VS Pascal Installation Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the installation process. If at any time 
you want to quit, type “QUIT” as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


sad The product minidisk will be linked using the following 


a default values: 

kkk 

cd Userid = (your userid) 

REE Minidisk address = <cuu> 

ak Password = (link password of the production minidisk) 
kk*K 

ae Change any of the above parameters? 

eK Enter 1 (YES) or © (NO) 

===> l 


*** Enter userid (or NULL for existing value): 


*** Enter minidisk address (or NULL for existing value): 
===> 192 
*** Enter password (or NULL for existing value): 


*** Installation of VS Pascal (5668-767) begins .... (note 2) 


*** Loading product files to disk ... 


*** Loading installation verification files ... 


*** Loading service files ... 


**x* What date format do you want? 

ae 1 (or US) for U.S. format (mm/dd/yy) 

wae 2 (or EUROPEAN) for European format (dd/mm/yy) 
bles null keeps the current format (US). 

===> EUROPEAN 


*e* What default message language do you want? 

1 (or UEN) for uppercase English 

2 (or ENG) for mixed-case English 

3 (or JPN) for Japanese (Kanji) 

null keeps the current default language (UEN). 
===> ENG 


Figure 1 (Part 1 of 2). Output from Installing VS Pascal Compiler and Library Product 


8 VS Pascal Installation and Customization Guide for VM 


*** Do you want to install the compiler above (note 3) 
*** the 16 megabyte line? 

iad Q (NO) for below the line 

ee, 1 (YES) for above the line 

wae null keeps the current location (BELOW). 


*** Customizing VS Pascal (5668-767) (note 2) 


Customizing DATE ... 
Customizing LANGUAGE ... 
Customizing XA... (note 3) 


( The output from the installation verification procedure is ) 
{ displayed here. See the Program Directory for an example of ) 
( the correct output. ) 
kkk VS Pascal KAKKKKKKEKAKA KKK KEKE KEKE KK KKK KKK KEE 


pa Product installation is complete. 
KREKKEKEKKKKKRREEKEEEKEEEKEKEREKEERERKEKKKEEREEEEKRERKEREREREKEKEKEEEKRKKEKKEEKE 


Figure 1 (Part 2 of 2). Output from Installing VS Pascal Compiler and Library Product 


Notes to Figure 1: How the output differs if you are installing the VS Pascal Library 
product (5668-717) only 


1. Enter “15668717” instead of “15668767”. 
2. The message indicates VS Pascal Library. 
3. These lines do not appear in your output. 


Step 3: Verifying the Output 


The installation EXEC automatically runs the installation verification procedure 
(IVP) after you finish installing VS Pascal. See the Program Directory for an 
example of the output from the IVP. 
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C Chapter 4. Customizing VS Pascal after Installation 


After VS Pascal has been installed, you can customize: 


e The DATETIME procedure 

e The default language 

¢ The uppercase and character translation tables 

e Where the compiler resides in relation to the 16-megabyte line. 


| This chapter explains how to change each option separately, and how to change a 
| number of options at one time. It also explains how to run the installation 
| verification procedure separately. 


Customizing the DATETIME Procedure after Installation 


Cc You can change the format of output from the DATETIME procedure any time after 
you have installed VS Pascal. You can customize the DATETIME procedure to 
return the current date as day/month/year (European format) or month/day/year 
(U.S. format). For more information on the DATETIME procedure, see VS Pascal 
Language Reference. 


Note: Make sure the production disk is not accessed with a filemode of “A” during 
customization. 


1. To customize the VS Pascal Compiler and Library product (5668-767), issue the 
‘ following command to invoke the installation EXEC: 


15668767 DATE 


To customize the VS Pascal Library product (5668-717), issue the following 
command to invoke the installation EXEC: 


15668717 DATE 


| Note: To stop the installation process, respond to any prompt with “QUIT”. If 
| you need to see the informational message again before answering the input 
prompt, enter “?” to review the material. 


‘~e | 2. To use the displayed linkage information, enter a “0”, “NO”, or press the 
| ENTER key without specifying a value. 


| To change any of the linkage information, enter “1” or “YES”, and change the 
| appropriate values. 


Note: If you are not the owner of (or are not linked to) the production minidisk, 
the installation EXEC prompts you to determine whether to force a logoff of the 
user ID that owns the production minidisk. If you enter “1” or “YES”, the 
installation EXEC forces off that user ID (if it is currently running disconnected 
in the system). If your user ID does is not authorized to force a logoff, you will 
| receive an error message. 


3. The installation EXEC prompts you for the U.S. or European date format. 
Enter “1” or “US” for U.S. date format, or “2” or “EUROPEAN” for European 
date format (you can also abbreviations such as “U” or “E”). If you press 
ENTER without specifying a new value, the installation EXEC leaves the 
Cc existing default in effect. 
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Any error messages you get during customization are listed in 
Appendix B, “Installation Messages” on page 33. 


Output from the customization procedure: Figure 2 shows the output from 
customizing the DATETIME procedure. The output from installing the VS Pascal 
Library is almost identical to Figure 2, and the differences are listed in the notes 
following the figure. The lines that begin with ===> indicate what you enter. 


===> 15668767 DATE (note 1) 
*** Begin VS Pascal Customization Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the customization process. If at any time 
you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


ae The product minidisk will be linked using the following 


baitaliel default values: 
KKK 


—e Userid = (your userid) 

sal Minidisk address = <cuu> 

iad Password = (link password of the production minidisk) 
KkX 

xe Change any of the above parameters? 

eee Enter 1 (YES) or © (NO) 

===> 1 


*** Enter userid (or NULL for existing value): 

==>> 

*** Enter minidisk address (or NULL for existing value): 
===> 192 

*** Enter password (or NULL for existing value): 


===> 


*** What date format do you want? 

as 1 (or US) for U.S. format (mm/dd/yy) 

ke 2 (or EUROPEAN) for European format (dd/mm/yy) 
Te: null keeps the current format (US). 

===> European 


*** Customizing VS Pascal (5668-767) ... (note 2) 
Customizing DATE ... 
( The output from the installation verification procedure is ) 


( displayed here. See the Program Directory for an example of ) 
( the correct output. 


kkk VS Pascal KKK KHKKKKKKKKEKKKEKKKEKKKEEEEEEKE EERE EKER KKK KKK 


aae Product customization is complete. 
KKKKKKKEKEKKKKEEKEEEEKEEE EE ERE EEK KEKE KEKE KK ERE 


Figure 2. Output from Customizing the DATETIME Procedure of the VS Pascal Compiler 
and Library Product 


Notes to Figure 2: How the output differs when you are customizing the VS Pascal 
Library product (5668-717). 
1. You enter “15668717 DATE” instead of “15668767 DATE”. 


2. The message indicates the VS Pascal Library. 
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After the installation EXEC has modified the library, it automatically invokes the 
installation verification procedure (IVP) to verify the product customization. The 
IVP issues a message stating whether the procedure was completed successfully 
or not. See the Program Directory for an example of the IVP output. 


Customizing the Default Language after Installation 


You can change the default language any time after you have installed VS Pascal. 
You can customize the default language to generate text in these languages: 


Uppercase English 
Mixed-case English 
Japanese. 


Note: Make sure the production disk is not accessed with a filemode of “A” during 
customization. 


1. 


To customize the VS Pascal Compiler and Library product (5668-767), issue the 
following command to invoke the installation EXEC: 


15668767 LANGUAGE 


To customize the VS Pascal Library product (5668-717), issue the following 
command to invoke the installation EXEC: 


15668717 LANGUAGE 


To use the displayed linkage information, enter a “0”, “NO”, or press the 
ENTER key without specifying a value. 


To change any of the linkage information, enter “1” or “YES”, and change the 
appropriate values. 


Note: If you are not the owner of (or are not linked to) the production minidisk, 
the installation EXEC prompts you to determine whether to force a logoff of the 
user ID that owns the production minidisk. If you enter “1” or “YES”, the 
installation EXEC forces off that user ID (if it is currently running disconnected 
in the system). If your user ID does is not authorized to force a logoff, you will 
receive an error message. 


. The installation EXEC prompts you to select a language. Enter the number or 


identifier of the new default language. 


Enter For Language 

1 or UEN Uppercase English 
2or ENG Mixed-case English 
3 or JPN Japanese 


If you press ENTER without specifying a new value, the installation EXEC 
leaves the existing default in effect. 


Any error messages you get during customization are listed in 
Appendix B, “Installation Messages” on page 33. 


Output from the customization procedure: Figure 3 on page 14 shows the output 
from customizing the default language. The output from installing the VS Pascal 

Library is almost identical to Figure 3, and the differences are listed in the notes 
following the figure. The lines that begin with ===> indicate what you enter. 
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===> [5668767 LANGUAGE (note 1) 
*** Begin VS Pascal Customization Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the customization process. If at any time 
you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


ee The product minidisk will be linked using the following 
ba default values: 


kkk 

eae Userid = (your userid) 

ae Minidisk address = <cuu> 

Ae Password = (link password of the production minidisk) 
Kkk 

Sad Change any of the above parameters? 

ee Enter 1 (YES) or 0 (NO) 

s===> l 

*** Enter userid (or NULL for existing value): 

===> 

*** Enter minidisk address (or NULL for existing value): 
===> 192 

*** Enter password (or NULL for existing value): 

===> 


*** What default message language do you want? 

1 (or UEN) for uppercase English 

2 (or ENG) for mixed-case English 

3 (or JPN) for Japanese (Kanji) 

null keeps the current default language (UEN). 
===> ENG 


*** Customizing VS Pascal (5668-767) ... (note 2) 
Customizing LANGUAGE ... 
( The output from the installation verification procedure is ) 


( displayed here. See the Program Directory for an example of ) 
( the correct output. ) 


kkk VS Pascal KHEEKKKKEKEEKEKEKEREE EKER REE KREEKEREEKREEKEEREREKKEERKEREKRK 


oat Product customization is complete. 
KRRKAKKKKKIHK KKK KKK KKK KK KEKE KEKE KEE ERK KKK A KKK IIE 


Figure 3. Output from Customizing the Default Language of the VS Pascal Compiler and 
Library Product 


Notes to Figure 3: How the output differs when customizing the VS Pascai Library 
product (5668-717) 

1. You enter “15668717 LANGUAGE” instead of “I5668767 LANGUAGE”. 

2. The message indicates the VS Pascal Library. 
After the installation EXEC has modified the library, it automatically invokes the 
installation verification procedure (IVP) to verify the product customization. The 


IVP issues a message stating whether the procedure was completed successfully 
or not. See the Program Directory for an example of the IVP output. 
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Customizing the Uppercase and Character Translation Tables after 


Installation 


You must first have installed VS Pascal before customizing the uppercase and 
character translation tables. 


Note: Customizing the uppercase and character translation tables applies only to 


the VS Pascal Compiler and Library product (5668-767). 


Before customizing the VS Pascal Compiler and Library product (5668-767), you 


must: 


1. Edit the file AMPXCAPS PASCAL as described below. 
2. Save the file back on the production minidisk. 


AMPXCAPS PASCAL contains 2 tables: 


e The uppercase table (AMPXUCASE ) which maps lowercase letters to their 


corresponding uppercase letters. For example: 


AMPXUCASE ['a'] := ‘A's 


¢ The character translation table (AMPXCCLASS), which maps characters to 
character classes. 


All character classes are defined in AMPXCAPS PASCAL. If applicable, their 
corresponding Graphic Character Global Identifiers (GCGIDs) are documented in 
the comment section next to each character class. The defined character classes 


are: 


Class 


$AMPERSAND 


$ARROW 
$SASTERISK 
$BAR 
$COLON 
$COMMA 
$DASH 
SDIGIT 
$SEOF 
$EQUAL 
$GREATER 
$SILLEGAL 
$LBRACK 
$LCURL 


Defines 
Ampersand 

At sign 

Asterisk 

Vertical bar 

Colon 

Comma 

Hyphen 

Digits from 0 to 9 
End-of-file 

Equal sign 

Greater than operator 
Illegal character 
Left square bracket 


Left brace 


GCGID 
SMO03 
SM05 
SM04 
SM13 
SP13 
SP08 
SP10 


SA04 


SA05 


SMO06 
SM14 
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Class Defines GCGID 
$LESS Less than operator SA03 
$LETTER All the characters that can start a VS Pascal 

identifier 
$LPARENT Left parenthesis SP06 
$NOT Logical-not operator SM66 
$PERCENT Percent sign SM02 
$PERIOD Period SP11 
$PLUS Plus sign 7 SA01 
$QUOTE Apostrophe SP05 
$RBRACK Right square bracket SMO08 
$RCURL Right brace SM11 
$RPARENT Right parenthesis SP07 
$SEMICOLON Semicolon SP14 
$SSHIFTIN Hex code '0F' 
$SHIFTOUT Hex code '0E' 
$SLASH Slash SP12 
$UNDERSCORE Underscore SP09 


Note: You can only customize the VALUE declarations for AMPXCCLASS and 
AMPXUCASE as described in the following sections. 


Next to each character VALUE declaration in the translation table, the comment 
section specifies any possible changes. /f the comment section is left blank, the 
character cannot be changed. For example, 


VALUE Declaration Comment Section 


AMPXCCLASS [' | '] := $BAR; (*Can be changed to *) 
(*$LETTER, $ILLEGAL, *) 
(*non SGCS character *) 
AMPXCCLASS ['&'] := $AMPERSAND; (* *) 


shows that the vertical bar is assigned character class of $BAR, and can be 
changed into character classes $LETTER, $ILLEGAL, or non-SGCS (Syntactic 
Graphic Character Set) characters. The ampersand is assigned to a character 
class of $AMPERSAND, and cannot be changed (indicated by the blank comment 
section). 


The Customization Procedure 
You can change the character translation table in several ways, you can: 


Use a different code point for a character class: If you have a different code point 


for a certain character class, you can change the code point within the square 
brackets. 
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For example, the VS Pascal compiler uses the “@” character as pointer notation (it 
is assigned to a character class of $ARROW). If you want to use a different 
character to denote the pointer notation: 


1. Find the line in AMPXCAPS PASCAL that assigns the character “@” toa 
character class $ARROW. 


2. Change character “@” to the character representing the code point you want 
to use. For example, if the code point you want to use for pointer notation is 
'BO'X (hexadecimal), the change looks like: 


AMPXCCLASS ['BO'XC] := $ARROW; 
The symbol 'XC' denotes the character representation of hexadecimal 'BO'. 
Use a different character class for a code point: If you want the VS Pascal compiler 


to treat certain code points differently, you can change the character classes of 
those code points. 


For example, if you do not want the VS Pascal compiler recognize the character 
“—,”, and you want it flagged as an illegal character, you can: 

1. Find the assignment statement of “<<” in AMPXCAPS. 

2. Check the comment section to see if character “—” can be changed. 


The assignment statement for the “—” character is: 


AMPXCCLASS ['—'] := $NOT; (*Can be changed to *) 
(*$LETTER, $ILLEGAL, *) 
(*non SGCS character *) 


3. The comment section indicates that the character class of “—.” can be changed 
to $LETTER, $ILLEGAL, or non-SGCS character. To make the VS Pascal 
compiler flag “—” as an illegal character, change the character class from 
$NOT to $ILLEGAL. 


Add a new code point: To make the compiler recognize a new code point, put the 
new code point into the table. 


For example, to use an “a” ('43'X) as a valid character in an identifier: 
1. Go to the VALUE declaration of AMPXCCLASS. 


2. Enter the definition of “a” into the character translation table. You can do this 
with the code: 


AMPXCCLASS ['43'XC] := $LETTER;  (*lowercase a umlaut *) 
AMPXCCLASS ['63'XC] := $LETTER; (*uppercase a umlaut *) 


3. Go to the VALUE declaration of AMPXUCASE. 


4. Change the uppercase table code to: 


AMPXUCASE ['43'XC] := '63'XC;(*map lowercase a umlaut to uppercase*) 
AMPXUCASE ['63'XC] := '63'XC;(*map uppercase a umlaut to itself *) 


Delete a code point: To delete code points, delete the assignment statements, or 
change the character classes to $ILLEGAL. 


The following table shows the character classes which need not have associated 
characters. VS Pascal provides alternative representations for these classes. You 
can use the alternatives listed for any code point you delete. Note, however, that 
some code points have special uses. 
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Class Alternatives Cautions 


$S$ARROW -> Causes flagging of pointer references 
when the compile-time option 
LANGLVL(ANSI83) is specified. 


SSHIFTIN DBCS literals will not work. 
$SHIFTOUT DBCS literals will not work. 
$LCURL (* Removes a standard Pascal character. 
$RCURL *) Removes a standard Pascal character. 
$LBRACK (. Removes a standard Pascal character. 
$RBRACK .) Removes a standard Pascal character. 


$AMPERSAND AND (for “&”) 
> < (for “&&”) 


$BAR OR (for “!”) 
+ (for “||”) 
$NOT NOT (for “.”) 


<> (for “=”") 


Note: For the compiler to work properly, you must: 
1. Change the character classes only to those specified in the comment section. 


2. Use each of the character classes at least once, except those that have 
alternative representations as specified above. 


Recovering the Original File After an Error 
If you discover that you incorrectly customized the tables, recover the file 
AMPXCAPS PASCAL by issuing the command: 


COPYFILE AMPXCAPS DEFAULT fm = PASCAL = (REP 
where fm is the file mode of the VS Pascal production minidisk. 


e If you have not yet invoked the installation EXEC, you can edit the file 
AMPXCAPS PASCAL again and then invoke the installation EXEC. 


e If you have already invoked the installation EXEC, you might be able to recover 
without reinstalling the product by invoking the installation EXEC with the 
CODEPAGE option. 


Note: If you have already invoked the installation EXEC, you might not be able 
to recover without reinstalling VS Pascal. Whether you can recover depends 
on the error in AMPXCAPS PASCAL. Try to recover without reinstalling VS 
Pascal by: 


1. Recovering the file AMPXCAPS PASCAL. 
2. Invoking the installation EXEC with CODEPAGE option. 


If there are errors during the customization process, then you have to reinstall 
VS Pascal. 
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| Running the Installation EXEC 

After saving the edited AMPXCAPS PASCAL file on the the product disk, customize 
the VS Pascal Compiler and Library product (5668-767) by invoking the installation 
EXEC with “CODEPAGE” specified. 


Note: Make sure the production disk is not accessed with a filemode of “A” during 
customization. 


1. To customize the VS Pascal Compiler and Library product (5668-767), issue the 
following command to invoke the installation EXEC: 


15668767 CODEPAGE 


2. To use the displayed linkage information, enter a “0”, “NO”, or press the 
ENTER key without specifying a value. 


| To change any of the linkage information, enter “1” or “YES”, and change the 
| appropriate values. 


| Note: If you are not the owner of (or are not linked to) the product disk, the 

| installation EXEC prompts you to determine whether to force a logoff of the 

| user ID that owns the product minidisk. If you enter “1” or “YES”, the system 
the installation EXEC forces off that user ID (if it is currently running 

| disconnected in the system). If your user ID does is not authorized to force a 
logoff, you will receive an error message. 


3. The installation EXEC asks if you want to customize the uppercase and 

| character translation tables. To use the standard uppercase and character 
translation tables, enter “0”, “NO”, or press ENTER without specifying a value. 
To customize the uppercase and character translation tables, enter “1” or 

TV EO 


| Any error messages you get during customization are listed in 
| Appendix B, “Installation Messages” on page 33. 


| Output from the customization procedure: Figure 4 on page 20 shows the output 


| from customizing the uppercase and character translation tables. The lines that 
| begin with ===> indicate what you enter. 


Chapter 4. Customizing VS Pascal after Installation 19 


===> [5668767 CODEPAGE 
*** Begin VS Pascal Customization Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the customization process. If at any time 
you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


ae The product minidisk will be linked using the following 
slieas default values: 


kkk 

did Userid = (your userid) 

Ane Minidisk address = <cuu> 

ae Password = (link password of the production minidisk) 
KKK 

ae Change any of the above parameters? 

eEK Enter 1 (YES) or @ (NO) 

==> 1 

*** Enter userid (or NULL for existing value): 

===> 


*** Enter minidisk address (or NULL for existing value): 


*** Enter password (or NULL for existing value): 


==s> 


*** Do you want to customize the uppercase and compiler 
*** character translation tables? 

Tee Q (or NO) keeps the default tables 

nae 1 (or YES) customizes the tables 

eae null keeps the current tables. 

===> ] 


*** Customizing VS Pascal (5668-767) ... 
Customizing uppercase and character translation tables ... 
( The output from the installation verification procedure is 


{ displayed here. See the Program Directory for an example of 
( the correct output. 


kkk VS Pascal KKEKKKIEKKEKKEKKKE KKK ERK KEK EK EKER EK IKKKE KERR KKK KKK KKARKKEKEKIKE 


saad Product customization is complete. 


KEKKKKKKKKREKEKEKEKEKEEKEEEREEKKEKE KEKE EER ERE REE ERR REE EKRKREKRKREREKEEKRKKEKE 


Figure 4. Output from Customizing the Uppercase and Character Translation Tables of the 


VS Pascal Compiler and Library Product 


After the installation EXEC has modified the tables, it automatically invokes the 
installation verification procedure (IVP) to verify the product customization. The 
IVP issues a message stating whether the procedure was completed successfully 
or not. See the Program Directory for an example of the IVP output. 
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_ Customizing the XA Option after Installation 


| You can change the location of the VS Pascal compiler any time after you have 
| installed the VS Pascal Compiler and Library product (5668-767). 


Note: Make sure the production disk is not accessed with a filemode of “A” during 
customization. 


1. To change the location of the VS Pascal Compiler, issue the following 
command to invoke the installation EXEC: 


| [5668767 XA 


| 2. To use the displayed linkage information, enter a “0”, “NO”, or press the 
ENTER key without specifying a value. 


To change any of the linkage information, enter “1” or “YES”, and change the 
appropriate values. 


Note: If you are not the owner of (or are not linked to) the product disk, the 
installation EXEC prompts you to determine whether to force a logoff of the 
user ID that owns the product minidisk. If you enter “1” or “YES”, the 
installation EXEC forces off that user ID (if it is currently running disconnected 
in the system). If your user ID does is not authorized to force a logoff, you will 
receive an error message. 


3. The Installation EXEC asks if you want to install the VS Pascal compiler above 
the 16-megabyte line. To use the default value shown, press the ENTER key 
without specifying a value. To install the VS Pascal compiler above the 

| 16-megabyte line, enter “1”, or “YES”. To install the VS Pascal compiler below 

| the 16-megabyte line or enter a “0”, or “NO”. 


Any error messages you get during customization are listed in 
Appendix B, “Installation Messages” on page 33. 


Output from the customization procedure: Figure 5 on page 22 shows the output 
from customizing the XA option. The lines that begin with ===> indicate what you 
enter. 
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===> [5668767 XA 
*** Begin VS Pascal Customization Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the customization process. If at any time 
you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


ae The product minidisk will be linked using the following 
baled default values: 


kkk 

Lac Userid = (your userid) 

Ree Minidisk address = <cuu> 

WES Password = (link password of the production minidisk) 
kkk 

itil Change any of the above parameters? 

wax Enter 1 (YES) or © (NO) 

===> 1 

*** Enter userid (or NULL for existing value): 

s==> 

*** Enter minidisk address (or NULL for existing value): 
z==> 192 

*** Enter password (or NULL for existing value): 

===> 


*** Do you want to install the compiler above 
*** the 16 megabyte line? 

ae 0 (or NO) for below the line 

aa 1 (or YES) for above the line 

wee null keeps the current location (BELOW). 


*** Customizing VS Pascal (5668-767) 


Customizing XA ... 


( The output from the installation verification procedure is ) 
( displayed here. See the Program Directory for an example of ) 
( the correct output. 


kkk VS Pascal KHIKKHKKKKK KKK KK KKK KKK KKK KKK KEKE KK KKK KKK KEKE KKEKEKEEK 


EK Product customization is complete. 
He Fe He He Ke He He IK ACK KA HATA KH KAKI KAKI KAKI IK KKK KKK KEKE KEKE KKK KKKEKKEEKIKK 


Figure 5. Output from Customizing the XA Option of the VS Pascal Compiler and Library 


After the installation EXEC has installed the compiler above the 16-megabyte line, 
it automatically invokes the installation verification procedure (IVP) to verify the 
product customization. The IVP issues a message stating whether the procedure 
was completed successfully or not. See the Program Directory for an example of 
the IVP output. 
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et 


Customizing Several Options in One Procedure 


You can change any grouping of options at one time, including: 


The format of the DATETIME routine 

The default Language 

The uppercase and character translation tables 

The location of the VS Pascal compiler in relation to the 16-megabyte line. 


This example shows you how to combine all options at one time. 


Note: Make sure the production minidisk is not accessed with a filemode of “A” 
during customization. 


T. 


To customize the VS Pascal Compiler and Library product (5668-767), issue the 
following command to invoke the installation EXEC: 


15668767 DATE LANGUAGE CODEPAGE XA 


To customize the VS Pascal Library product (5668-717), issue the following 
command to invoke the installation EXEC: 


15668717 DATE LANGUAGE 


Note: The XA and CODEPAGE options apply only to the VS Pascal Compiler 
and Library product (5668-767). 


. To use the displayed linkage information, enter a “O”, “NO”, or press the 


ENTER key without specifying a value. 


To change any of the linkage information, enter “1” or “YES”, and change the 
appropriate values. 


Note: If you are not the owner of (or are not linked to) the production minidisk, 
the installation EXEC prompts you to determine whether to force a logoff of the 
user ID that owns the production minidisk. If you enter “1” or “YES”, the 
installation EXEC forces off that user ID (if it is currently running disconnected 
in the system). If your user ID does is not authorized to force a logoff, you will 
receive an error message. 


. The installation EXEC prompts you for the “US” or “EUROPEAN” date format. 


Enter “1” or “US” for U.S. date format (month/day/year), or “2” or 
“EUROPEAN” for an European date format (day/month/year). You can also 
use an abbreviation such as “U” or “E”. If you press ENTER without specifying 
a new value, the installation EXEC leaves the existing default in effect. 


. The installation EXEC prompts you to select a language. Respond by entering 


the number or the three-character identifier of the new default language. 


Enter For Language 

1 or UEN Uppercase English 
2 or ENG Mixed-case English 
3 or JPN Japanese 


If you press ENTER, the installation EXEC leaves the existing default in effect. 


. The installation EXEC asks if you want to customize the uppercase and 


character translation tables. 


To use the standard uppercase and character translation tables, enter “0”, 
“NO”, or press the ENTER key without specifying a new value. To customize 
the uppercase and character translation tables, enter “1” or “YES” 
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Note: The CODEPAGE option applies only to the VS Pascal Compiler and 
Library product. 


“Customizing the Uppercase and Character Translation Tables after 
Installation” on page 15 explains how to customize the uppercase and 
character translation tables. 


6. The installation EXEC asks if you want to install the VS Pascal compiler above 
the 16-megabyte line. To use the default value shown, press the ENTER key 
without specifying a new value. To install the VS Pascal above the 
16-megabyte line, enter “1” or “YES”. To install the VS Pascal compiler below 
the 16-megabyte line (the default), enter a “O” or “NO”. 


Note: The XA option applies to the VS Pascal Compiler and Library product 
(5668-767). 


Any error messages you get during customization are listed in 
Appendix B, “Installation Messages” on page 33. 


Figure 6 shows the portion of the output from customizing the options. The lines 
beginning with ===> indicate what you enter. The output from installing the VS 
Pascal Library is almost identical to Figure 6, and the differences are listed in the 
notes following the figure. 


===> 15668767 DATE LANGUAGE CODEPAGE XA (note 1) 
*** Begin VS Pascal Customization Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the customization process. If at any time 
you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


eee The product minidisk will be linked using the following 
ae default values: 


eke Userid = (your userid) 

wee Minidisk address = <cuu> 

slaal Password = (link password of the production minidisk) 
KEK 

ee Change any of the above parameters? 

kak Enter 1 (YES) or @ (NO) 

==> 1 


*** Enter userid (or NULL for existing value): 

===> 

**k Enter minidisk address (or NULL for existing value}: 
===> 192 

*** Enter password (or NULL for existing value): 


==S> 


Figure 6 (Part 1 of 2). Output from Customizing Several Options in One Procedure of the 
VS Pascal Compiler and Library Product 
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*** What date format do you want? 

cE 1 (or US) for U.S. format (mm/dd/yy) 

AEX 2 (or EUROPEAN) for European format (dd/mm/yy) 
see null keeps the current format (US). 

===> EUROPEAN 


*** What default message language do you want? 

1 (or UEN) for uppercase English 

2 (or ENG) for mixed-case English 

3. (or JPN) for Japanese (Kanji) 

null keeps the current default language (UEN). 
===> ENG 


*** Do you want to customize the uppercase and compiler (note 2) 
**x* character translation tables? 

es © (or NO) keeps the default table 

aEe 1 (or YES) customizes the tables 


nee nuli keeps the current tables. 
===> 1 


*** Do you want to instal] the compiler above (note 2) 
*** the 16 megabyte line? 

sa Q (or NO) for below the line 

Te 1 (or YES) for above the line 


ee null keeps the current location (BELOW). 
===> 1 


*** Customizing VS Pascal (5668-767) (note 3) 


Customizing DATE ... 
Customizing LANGUAGE .. 


Customizing uppercase and character translation tables ... (note 2) 
Customizing XA ... (note 2) 
( The output from the installation verification procedure is ) 
( displayed here. See the Program Directory for an example of ) 
( the correct output. ) 


KX VS Pascal KEKKEKEKKAKKKEKERREEKREREKKEKREKREKRKKRERRERKERERREKR KKK RRR KKK 


ase Product customization is complete. 
KKKKKKEKKEKEKEREKKKEKEKKEKEREKRRKERKEEKKEEKREEKKERKEKREEKEREKRKRKRRKKERKERERRR RK 


Figure 6 (Part 2 of 2). Output from Customizing Several Options iri One Procedure of the 
VS Pascal Compiler and Library Product 


Notes to Figure 6: How the output differs when you are customizing the VS Pascal 
Library product (5668-717) 


1. You enter “15668717 DATE LANGUAGE” instead of “15668767 DATE LANGUAGE 
CODEPAGE XA”. 


2. These lines do not appear in your output. 

3. The message indicates VS Pascal Library product. 
After the installation EXEC has modified the library, it automatically invokes the 
installation verification procedure (IVP) to verify the product customization. The 


IVP issues a message stating whether the procedure was completed successfully 
or not. See the Program Directory for an example of the IVP output. 
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Running the Installation Verification Procedure Separately 


The installation EXEC automatically runs the installation verification procedure 
(IVP) after VS Pascal has been installed or customized. Occasionally, you might 
have to run the IVP separately, such as when you install VS Pascal service tape. 
See Appendix C, “Servicing VS Pascal” on page 41 for more information. 

To run the IVP separately: 


To verify the VS Pascal Compiler and Library product (5668-767), issue the 
command: 


V5668767 


To verify the VS Pascal Library product (5668-717), issue the command: 
V5668717 


See the Program Directory for an example of the IVP output. 
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Cc 


Chapter 5. Installing and Customizing VS Pascal under VM/IS 


Installing and customizing VS Pascal under VM/IS are two separate steps, unlike 
installing under VM/CMS. 


When you install VS Pascal under VM/IS the product is installed using the 
IBM-supplied defaults. That is, the VS Pascal Compiler and Library product 
(5668-767) is installed with: 


U.S. date format 

Uppercase English as the default language 

Standard uppercase and character translation tables 
The compiler below the 16-megabyte line 


and the VS Pascal Library product (5668-717) is installed with: 
U.S. date format 


Uppercase English as the default language. 


You can customize VS Pascal under VM/IS using the same procedure as 
customizing VS Pascal under VM/CMS. See Chapier 4, “Customizing VS Pascal 
after Installation” on page 11 for more information, and the exact procedures. 


Installing VS Pascal under VM/IS 


Install VS Pascal under Virtual Machine/Integrated System by invoking the 
installation tool INSTFPP, which invokes the VS Pascal installation EXEC. 
INSTFPP does the following: 

1. Defines temporary MAINT 001 minidisk and formats it as the C-disk. 

2. Defines temporary MAINT 002 minidisk and formats it as the A-disk. 
3. Accesses MAINT 319 minidisk as the P-disk. 
4 


. Loads the Product Identifier File, the product installation EXEC, and the product 
Memo to Users from the VS Pascal IBM Software Distribution (ISD) tape onto 
MAINT’s 001 temporary C-disk. Once this is done, the ISD tape is positioned at 
the beginning of the third tape file of the product. 


5. Copies the Memo to Users from the temporary C minidisk to the MAINT 319 
minidisk. 

6. Reads the first record of the Product Identifier File. This record contains the 
product description. 


7. Issues a prompt asking if the installer wishes to print the Program Product's 
Memo to Users. 


If you answer “YES”, INSTFPP prints the memo. 
If you answer “NO”, INSTFPP continues with step 8. 

8. Issues a prompt asking if the you want to install the VS Pascal. 
lf you answer “NO”, the installation is terminated. 


lf you answer “YES”, INSTFPP executes the VS Pascal installation EXEC and 
checks the return code passed back from the installation EXEC. 
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After the VS Pascal installation EXEC has been invoked: 


¢ You can stop the installation process by responding “QUIT” to any prompt. If 
you want to see the informational message again before answering the input, 
enter “?” to review the material. 


¢ To use the displayed linkage information, (user ID, minidisk address, and 
READ/WRITE password of the product minidisk) enter a “0”, “NO”, or press the 
ENTER key without specifying a value. 


To change the displayed user ID, minidisk address, or product minidisk 
password enter a “1” or “YES”. You are then prompted to enter the new 
values. 


If you are not the owner of (or not linked to) the product disk, you can force a 
logoff of the user ID that owns the product minidisk. If you enter a “1” or 
“YES”, the installation EXEC forces off that user ID (if it is currently running 
disconnected in the system). 


Note: If your user ID is not authorized to force a logoff, you will receive an 
error message. 


Upon exit, the installation EXEC passes a return code to INSTFPP. INSTFPP 
updates the PROD LEVEL file. This file records the status of the installation 
according to the return code it receives. 


Figure 7 on page 29 shows the output from installing under VM/IS. The lines that 
begin with ===> indicate what you enter. 
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*** Begin VS Pascal Installation Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the installation process. If at any time 

you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


ak The product minidisk will be linked using the following 
ae default values: 


K*e* 

pis Userid = MAINT 

died Minidisk address = 19E 

nae Password = MMAINT 

kek 

ae Do you want to change any of the above parameters? 
ae Enter 1 (YES) or © (NO). 

===> 0 


*** Installation of VS Pascal (5668-767) begins .... 


*** Loading product files to disk ... 


*** Loading installation verification files ... 


*** Loading service files ... 


( The output from the installation verification procedure is ) 
( displayed here. See the Program Directory for an example of ) 
( the correct output. ) 


kek VS Pascal KKEKKRKEKAKKKR KKK EK RRR RRR RK RRR 


me Product installation is complete. 
Kk KKKKKKRKKKK KKK KR RAK KKK RR KKK KKK KKK RK RR KKK KAR RRR RR RR RK 


Figure 7. Output from Installing VS Pascal Under VM/IS 


Customizing VS Pascal under VM.1IS 


The customization procedure for VM/IS is the same as that for VM/CMS. 


To Customize See Page 
Date format 11 
Default language 13 
Uppercase and character translation tables 15 
Location of VS Pascal compiler 21 
Several options in one procedure 23 


Note: If you are installing the VS Pascal Library product (5668-717), you can 
customize only the date format and the default language. 
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Appendix A. Summary of Changes 


VS Pascal Release 2 provides additions and enhancements to VS Pascal Release 1 
in the following areas: 


System Flexibility 


VS Pascal now: 


Runs under VM/Extended Architecture (VM/XA). 
Runs under MVS/Enterprise Systems Architecture (MVS/ESA). 


Transient Run-Time 


Users now have the option to: 


Create modules which are self-contained, or which can dynamically access 
run-time routines. The transient run-time library will help free up resources 
in large-scale, modular systems that must serve multiple users. Transient 
run-time reduces the size of load modules and makes it unnecessary for 
each user to maintain a copy of the run-time library. 


National Language Support 


Release 2 also: 


Allows customization of character translation and uppercase tables at 
installation. This eases compiler recognition of tokens and characters due 
to national programming standards, and allows creation of uppercase 
rules. 


Provides three languages from which sites choose a default language 
during installation. At both run-time and compile-time, users can override 
the default language with another language. Currently, VS Pascal provides 
mixed-case English, uppercase English, and Japanese. 
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Appendix B. Installation Messages 


The following messages might be appear during the installation of VS Pascal. An 
explanation of each message with a user response is provided. The error 
messages for the installation verification procedure (IVP) are listed in “IVP Error 
Messages” on page 39. 


VS Pascal Installation Error Messages 


These messages appear during installation of the VS Pascal Compiler and Library 
product (5668-767) or during installation of the VS Pascal Library product 
(5668-717). 


111 *** VS Pascal or VS Pascal Library ******************** 
*** User requested termination. 


RAEKEKKKEKKEEEREKKEKREEKEEKEKEKEKEEEEEKEKEKEEKREREKEEKEEEEKEEEKKEEEEKKKEE 


Explanation: During installation, the user answered “QUIT” when asked to select 
an installation option. 


User Response: Determine which option, if any, is desired and rerun the 
installation EXEC. 


200 xkk VS Pascal or VS Pascal Library REREKEEREKEEREKKKEKEK 
*** name is required for product installation. 
*** Installation is terminated. 


KREKEREKEKREREKEKKEKEKEKEEKEREEEEEKEEEREEEEEEEREEKEKREEKKEKREKKEREKREKKEK 


Explanation: The name command returned a negative return code. The most 
likely cause would be that the named command could not be found. 


User Response: Check to see if the Y-disk (19E) has been released; if so, reaccess 
it. Otherwise, check with your local system support personnel. After fixing the 
problem, begin the installation process again. 


205 *** VS Pascal or VS Pascal Library ******************** 
*** name failed with return code = rc 
*** Installation is terminated. 


KRHREKKEKEEEKKEKEEREKREKKEKKEEEEKREKRKEKEKREEKEKEEKEEREREKKEKEKEEEEKKKKK 


Explanation: The name command unexpectedly failed. 


User Response: As indicated, this is an unexpected failure and you will have to 
determine the cause. Consult the appropriate manuals to determine why the 
command might have failed. 
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210 *** VS Pascal or VS Pascal Library ******************** 
*** CP FORCE command failed to force a logoff < userid > 
*** Check userid class privileges. 
*** Installation is terminated. 


HEKKREKKKKEEERREKEKEKEEKEEKREEKEREEEEREREREEEEKEREREEKEEEKREKEEKKE 


Explanation: The product disk specified is not in read/write mode. Attempt to 
force a logoff fails. 


User Response: Ensure that the production disk is in read/write mode, or check 
userid class privilege. Invoke the installation EXEC again. 


215 *** VS Pascal or VS Pascal Library ******************** 
*** Error linking to diskcuu as devaddr. 
*** Return code = rc from CP LINK command. 
*** Installation is terminated. 


REKKEREKEEEEKEEREKEEEREEEEEKKEEREEEREREEEEEEEREEEEEEEEEEEEEEKKE 


Explanation: The LINK command failed with return code rc trying to link to disk 
diskcuu as devaddr. 


User Response: Determine why the LINK command failed. The most probable 
cause for failure is an incorrect password. See the appropriate CP Command 
Reference for your VM system for specific command error codes and conditions. 
After correcting the problem, rerun the installation procedure. 


220 *** VS Pascal or VS Pascal Library ******************** 
*** Tape at device address 181 is not the ISD product tape 
*** for this product. 
*** Installation is terminated. 


HKKEKKEKEKEKREKEKEKEEKEKREREEKREREEREREERERREREKEREEEEKEREEKEKEEKE 


Explanation: A scan of the tape at device 181 was done to determine if the VS 
Pascal product tape was mounted at 181. This error indicates that the tape on 
device 181 was not recognized as an ISD product tape for VS Pascal. 


User Response: Mount the ISD product tape for VS Pascal on tape drive 181 and 
start the installation process over. 


225 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred while trying to function tape. 
*** Return code = rc from the CMS VMFPLC2 command. 
*** Installation is terminated. 


KRKAEKEKEREREEEERKEEREEEKKEREEREEEEREEEREREREKREREEEEAEKKREREKKEKEKE 


Explanation: A tape error occurred while trying to perform the function specified 
by function. 


User Response: Define more disk space or correct the tape error and reexecute 
the EXEC. See the appropriate CP Command Reference for your VM system for a 
more specific explanation of VMFPLC2 errors (see the TAPE command). 
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230 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred while loading files from installation 
*** tape to disk. 
*** Installation is terminated. 


RREKEKEKREKEREKREKEREKEEEKKEEEKEKREKEKEKEKEKEKEEEEKKEEKKEEKKKKEKER 


Explanation: The disk is full or a tape error has occurred. 


User Response: Define more disk space or correct the tape error and reexecute 
the EXEC. See the appropriate CP Command Reference for your VM system for a 
specific explanation of VMFPLC2 errors (see the TAPE command). 


235 *** VS Pascal or VS Pascal Library ******************** 
*** A normally non-terminating error occurred during 
*** installation with the NOPROMPT option specified. 
*** Installation is terminated. 


KEEKEKEKEKEKKEREKRKEKEEKEKEKREEKEEKEKEKEREKEEKEKEKKEKEEKEREEKEEKE 


Explanation: An error that normally does not terminate the installation EXEC 
occurred with the NOPROMPT option specified. 


User Response: Restart the Installation EXEC without the NOPROMPT option. 


240 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred copying the product files. 
*** Return code = rc. 
*** Installation is terminated. 


RKKKKKEKKEKEKKEEKEKEEEKEEREKCEEREKEKKEEKEEEEKEEEKRERKEEEEKKEEEKKEEKKKEE 


Explanation: When VS Pascal is customized or serviced, product files are copied 
back and forth between a temporary disk and the “product” disk. This error can be 
caused by a file not existing or the product disk not having enough space to hold 
the files. 


User Response: Determine which file does not exist and find out why it was not 
generated. See the appropriate CP Command Reference for your VM system for 
specific command error codes and conditions. For disk space problems, increase 
the space allocated for the production disk. The installation process must then be 
rerun. 


245 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred updating the product <type> library, 
*** (name). 
*** Return code = rc. 
*** Installation is terminated. 


RAKKEKREKEKEEEKEEKEEEEKREKEKREEKEEEEEKEEEEREEKEREKKKEKKKKEKKKKKKKKEK 


Explanation: When the library is customized or serviced, certain TXTLIBs and 
LOADLIBs must be modified. This error can be caused by a file not existing or by 
the failure of the TXTLIB or LKED commands. 


User Response: Determine which file does not exist and find out why it was not 
generated. See the appropriate CP Command Reference for your VM system for 
the specific command error codes and conditions. The installation process must 
then be rerun. 
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250 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred while re-generating the compiler. 
*** Return code = rc. 
*** Installation is terminated. 


REKKAKKEKEEREERKEEEEEREREEREREREREKREREEEEKEEKEKEEREREREEREREEEE 


Explanation: When the product is customized or serviced, certain phases of the 
product must be regenerated. This error can be caused by a file not existing or by 
the failure of the LOAD or GENMOD commands. 


User Response: Determine which file does not exist and find out why it was not 

generated. See the appropriate CP Command Reference for your VM system for 
specific command error codes and conditions. The installation process must be 
rerun. 


255 *** VS Pascal or VS Pascal Library ******************** 
*** Error occurred while trying to get a temporary disk 
*** (name). Return code = rc. 
*** Installation is terminated. 


HRAAKEKKEKEERREEEEREEEEEEEEEREKEEEEEKREEEKEEEEREEEEEEKEEREKEEEEEERE 


Explanation: This error occurs when a temporary disk can not be obtained for a 
variety of reasons (name): no device address available, a CP DEFINE error, ora 
CMS FORMAT error. 


User Response: If a device address is not available, then one needs to be freed up 
(in the range 210-280). For a DEFINE error, consult the CP Command Reference 
manual. For a FORMAT error, see the appropriate CP Command Reference for 
your VM system. 


260 tek ke VS Pascal or VS Pascal Library REKKRKEKKEREKEERERKKK 
*** No maintenance files exist for this product. 
*** Service Is terminated. 


ARAEKEKKEEREEEEREKEEREEEEEEEKEEREKEEEEKREEEEREKKREREKEEEEKEEEREKKEEEE 


Explanation: When invoked with the PTF option the installation EXEC expects to 
find all service files on the PTF tape. This error indicates that none were found. 


User Response: Ensure that the PTF or PUT tape being used is a VS Pascal 
service tape. Correct the error and reexecute the service procedure. 


265 *** VS Pascal or VS Pascal Library ******************** 
*** Problem occurred while performing the LISTFILE 
*** command on the Product Identifier File. 
*** Return code = rc from the CMS LISTFILE command. 
*** Installation is terminated. 


RAERARKEKEKEKEEEEEEEEKEKEEEEKERKEEREEREREEEREEREREKEKEEEREREEREREE 


Explanation: The Product Identifier File is not found. 


User Response: Check and make sure that the Product Identifier File exists. 
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270 *** VS Pascal or VS Pascal library ******************** 
*** The number of tape files as specified by the 
*** Product Identifier File is non-numeric. 
*** Installation is terminated. 


EREKKEKEKEEEEKREREKRREKEKKEREREREEKERERRERKEREREKREKKEKKKKKKKKKE 


Explanation: The installation exec determines number of tape files dynamically 
from the Product Identifier File. The last digit of the Product Identifier File type 
specified the number of tape files. 


User Response: Check and make sure that the last digit of the Product Identifier 
File is a digit. 


275 *** VS Pascal or VS Pascal Library ******************** 
*** Error compiling module name. 
*** Return code = rc. 
*** Installation is terminated. 


REKRKEKEKRREKEREEREREEREREREERERRERRERERREREREEREREERERERRERKEKKE 


Explanation: Errors occur when trying to compile or assemble the customized 
source modules. 


User Response: Make sure the correct customized source modules are used. 
(There may be another version of the customized source modules on another disk.) 


280 kkk VS Pascal RAKKEKERKEREEREREEKERERKEEKREEKREREERERKKKEKRKEKKE 


*** The compiler cannot be installed above the 16-megabyte 
*** line in VM/SP environment. 
*** Installation is terminated. 


RAEKKEEKEEKEEKEERERAEREEKERREEEEREEEEREEEKREKEEEKEKEEKEKKEKKAKRKKKK 


Explanation: The error occurs when trying to install the compiler above the 
16-megabyte line in a VM/SP environment. 


User Response: Install the compiler below the line or run the installation exec ina 
VM/XA environment. 


285 *** VS Pascal or VS Pascal Library ******************** 
*** Error formatting <userid> <cuu> minidisk 
*** Return code = rc. 
*** Installation is terminated. 


KAKKKKKREKKKKEKEKREKEKEEKEKEEEREKEEEKEEEEREEEEEREREEEEREEEERKKKE 


Explanation: This error occurs when the production minidisk cannot be formatted. 


User Response: Determine why the FORMAT command failed. See Virtual 
Machine/System Product CP Command Reference for General Users for specific 
command error codes and conditions. After correcting the problem, rerun the 
installation procedure. 
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666 akk VS Pascal or VS Pascal Library RAEEKEAAEEEKEEKEREEKE 
*** Tape drive 181 is not available. 
*** Installation is terminated. 


RAERAEAEKEKREREKREEREREEEEEEEREREREREEREEREEEREEEEEEREREREEEREKREEER 


Explanation: Tape drive (device address 181) was not attached to the user’s virtual 
machine. 


User Response: Correct the problem and start the installation again. 


888 *** VS Pascal or VS Pascal Library ******************** 
*** All necessary files have been loaded from tape, but 
*** verification must be done manually. 
*** Installation is terminated. 


RAKKRAEKKEKERAEKEKEKEERERREKREKREEKREEEREKREKEEREREEKREEEEKEREREEKKKEEK 


Explanation: Product installation completed successfully. However, the 
verification procedure was not executed during the installation procedure. This is 
caused when the EXEC that does the verification process could not be found. 


User Response: See if the file (V5668767 or V5668717 EXEC) is on the installation 
tape. If it is, load it and start the installation process again. If it is not on the tape, 
then report the problem to the IBM Support Center. 


999 *** VS Pascal or VS Pascal Library ******************** 
*** All necessary files have been loaded from the tape, 
*** but verification failed. 
*** Installation is terminated. 


RAKKKEAEKEEERKEKEEREEKEEEEKEREKRKEREEEKRERERKEKEEEKREREKEKREEKEEEEKRER 


Explanation: An error occurred during the execution of the verification procedure. 


User Response: Ensure that all files have been generated correctly; run the 
installation verification procedure as described in “Running the Installation 
Verification Procedure Separately” on page 26. 


999 *** VS Pascal or VS Pascal Library ******************** 
*** Fatal error during installation. 
*** Return code = rc. 
*** Installation is terminated. 


RAKKKAKKEKERKEKEEKEKKEEREKRERKERREKRERERKEEERERREREREEKREURERERKKKEK 


Explanation: A failure occurred during the execution of the installation procedure 
with return code rc. This error should only occur if the EXEC was incorrectly 
modified. 


User Response: If the EXEC has not been modified (that is, it is identical to the 
version on the installation tape), then report the problem to the IBM Support 
Center. 
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C IVP Error Messages 


The following error messages might appear during the installation verification 
procedure. 


300 *** VS Pascal or VS Pascal Library ******************** 
*** File name not found. 
*** File is required for product verification. 
*** Verification is terminated. 


HEEKEEKREEEEKREEREEREEEEREEREREEKREREERERREKREEEEKEREREKKKKKKKKKKKK 


Explanation: This error is caused by the file name not existing. 


User Response: Ensure that all files have been loaded and generated correctly; 
run the installation verification procedure as described in “Running the Installation 
Verification Procedure Separately” on page 26. 


305 *** VS Pascal or VS Pascal Library ******************** 
*** The compilation of the sample program failed. 
*** Verification is terminated. 


HRHREKKEKKEEKRKEKEKRRERERREREERERREREEREREEKEEEEREEKEREEEEKEKKKREEKKE 


Explanation: An error occurred during the compilation of the sample program. 


User Response: Ensure that all files have been generated correctly; run the 
installation verification procedure as described in “Running the Installation 
( Verification Procedure Separately” on page 26. 


310 *** VS Pascal or VS Pascal Library ***************#*##** 
*** The execution of the sample program failed. 
*** Verification is terminated. 


KHREKEKRKEKEREEEREEERREEREEEEEREEEEEEEREREREKRERERERERRERERKEKKKKE 


Explanation: An error occurred during the execution of the sample program. 


User Response: Ensure that all files have been generated correctly; run the 
c installation verification procedure as described in “Running the Installation 
‘S Verification Procedure Separately” on page 26. 


999 *** VS Pascal or VS Pascal Library ******************** 
*** Fatal error during installation verification. 
*** Return code = rc 
*** Installation is terminated. 


HERRERA ERERAEKEEEERREEREKRERREEREKEEEEKREKEKREKKEKKKAKEKE 


Explanation: A failure occurred during the execution of the verification procedure 
with return code rc. This error should only occur if the EXEC was incorrectly 
modified. 


User Response: If the EXEC has not been modified (that is, it is identical to the 
version on the installation tape), then report the problem to the IBM Support 
Center. 
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Appendix C. Servicing VS Pascal 


IBM provides corrective and preventive service for product defects and support for 
resolving program problems through Central Service, including the IBM Support 
Center. For details of these facilities and a list of all the products supported, refer 
to Programming System General Information Manual, G229-2228. 


When you encounter a failure in the product, follow the steps outlined in the VS 
Pascal Diagnosis Guide and Reference to determine if an authorized programming 
analysis report (APAR) is required, or if a prograrn temporary fix (PTF) can be 
requested. 


An APAR is resolved by Central Service with either an explanation, or a new 
corrective service program temporary fix (PTF) for the defect. APTFisa 
replacement part that is installed in the product to correct the defect. Collections 
of new PTFs for products are provided to all customers as preventive service 
program update tapes (PUTs). 


Installing VS Pascal PTFs 


IBM distributes corrective service on a program temporary fix (PTF) to a specific 
customer. A PTF contains a correction for a single Known probiem in a particular 
product. As soon as a new problem is identified and the solution is established, a 
PTF is created and made available on a corrective service tape. 


Enclosed with each corrective service tape is a Memo to Users, which contains a 
list of the tape’s contents and a cover letter for each PTF on the tape. 


VS Pascal corrective service tapes do not include service EXECs, but you can use 
the installation EXEC with the “PTF” option to install the corrective service PTFs. 


Notes: 
Disregard the PTF service procedure included in file 1 of the service tape. 


Two tapes are used in this procedure, the corrective service tape and a 
“scratch” tape. This is necessary because the installation EXEC is written 
for tape load operations. 


To use the installation EXEC, use the following procedure: 


1. Copy your current VS Pascal production disk to another disk (the temporary 
production minidisk). This ensures that you have a working version of the 
current product in case something goes wrong when applying the service. 
Make sure one of these two minidisks is not accessed while you are installing 
the corrective service PTFs. Access the temporary production minidisk as your 
target disk, with a file mode of “B”. 


2. Choose a second disk for use as a staging disk to contain the incoming 
corrective service files. The installation EXEC later accesses this disk witha 
file mode of “A”. 


3. Access the disk containing the installation EXEC with a file mode of “C”. 


4. Mount the corrective service tape at virtual address 181. 
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5. 


10. 


11. 


Position the corrective service tape to the beginning of the first VS Pascal 
service file. Use the command: 


VMFPLC2 SCAN fn ft (EOT 


to position the tape, where fn is 5668767 for the Compiler and Library product 
or 5668717 for the Library only product, and ft is 010101. 


Note: Do not use VMSERV to install this tape. The tape is not in VM PUT 
format. 


. Manually load the files from the tape using the command: 


VMFPLC2 LOAD * * A (EOF 2 


. To invoke the renaming EXEC for the VS Pascal Compiler and Library product, 


issue the command: 
5668767 


To invoke the renaming EXEC for the VS Pascal Library product only, issue the 
command: 


5668717 


The renaming EXEC changes the file types of the desired corrective service 
PTFs to the file types required by the installation EXEC. 


Note: This is necessary because the tape files have the PTF number included 
in the file type; for example, AMPOTRAN TXTnnnn (where nnnn is the PTF 
number). 


The renaming EXEC changes the file type to the format used by the installation 
EXEC; for example, TXTnnnn is changed to TEXT. Each PTF you order will 
have a unique renaming EXEC. 


. Rename or erase the renaming EXEC on the “A” disk. 


. If there is more than one VS Pascal corrective service PTF on the tape, repeat 


steps 5 through 8 for each PTF. 


Each PTF has files with file types indicating the proper file type (for the 
renaming EXEC) and the PTF number. As each PTF is taken off the tape and its 
files renamed, certain files may need to be replaced or erased. Ensure that 
the renaming EXEC takes the PTFs from the tape in the correct sequence and 
properly replaces or erases the files. 


When all PTFs are taken off the tape, all files that are used by the installation 
EXEC should have the proper file types. The installation EXEC should now be 
able to process these files and incorporate them into the product. 


Mount the scratch tape at virtual address 181 if you have not already done so, 
and dump all the files from the “A” disk to the scratch tape using the 
command: 


VMFPLC2 DUMP * * A 
Note: Remember that the corrective service tape is not in VM PUT format. 


Release the staging disk “A”. 
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12. To invoke the installation EXEC for the Compiler and Library product, issue the 
command: 


15668767 PTF 


To invoke the installation EXEC for the Library only product, issue the 
command: 


15668717 PTF 


Note: To stop the installation process, respond to any prompt with “QUIT”. If 
you need to see the informational message again before answering the input 
prompt, enter “?” to review the material. 


13. To use the displayed linkage information, enter a “0”, “NO”, or press the 
ENTER key without specifying a value. 


To change any of the linkage information, enter “1” or “YES”, and change the 
appropriate values. 


Note: If you are not the owner of (or are not linked to) the production minidisk, 
the installation EXEC prompts to determine whether to force a logoff of the 
user ID that owns the production minidisk. If you enter “1” or “YES”, the 
installation EXEC forces off that user ID (if it is currently running disconnected 
in the system). 


The installation EXEC: 


1. Defines a temporary disk “A” 
2. Loads the renamed text files and other service files onto the “A” disk. 
3. Installs the service from the “A” disk to the temporary product disk. 


If an error occurs, an error message is issued and the PTF installation procedure 
terminates. 


After the installation EXEC has applied service for the PTF tape, it automatically 
invokes the installation verification procedure (IVP) to verify the service 
installation. You will be given a message stating whether the IVP completed 
successfuliy or not. See the Program Directory for an example of the output from 
the IVP. 


Figure 8 on page 44 shows the output from installing a PTF. The lines beginning 
with ===> indicate what you entered. 
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===> [5668767 PIF 
*** Begin VS Pascal Maintenance Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the maintenance process. If at any time 

you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


wae The product minidisk will be linked using the following 


as default values: 

KKK 

nee Userid = (your userid) 

sa Minidisk address = <cuu> 

ae Password = (link password of the production minidisk) 
kkk 

ibe Do you want to change any of the above parameters? 
are Enter 1 (YES) cr @ (NO). 

===> l 


*** Enter userid (or NULL for existing value): 


===>. 

*** Enter minidisk address (or NULL for existing value): 
===> 192 

*** Enter password (or NULL for existing value): 

emg 


*k* Servicing VS Pascal (5668-767) ... 


*** Moving product files from temporary work disk to product disk ... 


( The output from the installation verification procedure is ) 
( displayed here. See the Program Directory for an example of ) 
( the correct output. ) 


KKK VS Pascal KKKKEKKKK KK KKK KEK KEKE KEK KEK EK KKK KKK EIR REE KKK KK EKRKEKEKKEKKEKKE 


*** Product maintenance is complete. 
KEKKKKKKKKEEKEKKEKEKEKE KEKE KKK KEKE EKER KEE KK KEKE KEKE KEKRKKEKEKK KER EKEKRKREKRKEKEKREKE 


Figure 8. Output from Installing a PTF 
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Installing VS Pascal Service from a PUT Tape 


IBM distributes preventive service on Program Update tapes (PUTs) to ail 
customers on a regular basis. 


The service tape contains all the service EXECs necessary for installation, and the 
installation EXEC is located on your existing production disk. 


To apply the VS Pascal fixes distributed on the service tape, perform the following 
steps: 


1. 


Copy your current VS Pascal production disk to another disk. This ensures that 
you have a working version of the current product in case something goes 
wrong when applying the service. Make sure that one of the two production 
disks is not accessed while installing the PUT tape. Access the other disk as 
your target disk, with a file mode of “E”. 


Choose a second disk to contain the VMSERV EXEC. Access this disk witha 
file mode of “C”. 


Mount the PUT tape at virtual address 181. 
Issue the command 

VMFPLC2 LOAD * * C 

to load the VMSERV EXEC onto the “C” disk. 
Issue: 

VMSERV 


The VMSERV EXEC asks you if you want to print the memo to users. Answer 
YES. The EXEC issues the print command and then terminates. 


. When you have finished reading the memo to users, issue the command: 


VMSERV 


Answer “NO” to the memo to users prompt. 


. The VMSERV EXEC then asks if you want to install the service. Answer YES to 


this prompt. VMSERV then loads the first service EXEC, advances the tape to 
the beginning of the first service file, and invokes the service EXEC to install 
the first service file. The service EXEC defines a temporary minidisk and 
accesses it with the file mode of “A”. The service EXEC then loads the service 
file(s) onto the A disk and calls the installation EXEC to install the service. 


To use the displayed linkage information, enter a “0”, “NO” or press the enter 
key without specifying a value. 


To change any of the linkage information, enter “1”, or “YES”, and change the 
appropriate values. 


Notes: 


a. To stop the installation process, respond to any prompt with “QUIT”. If you 
need to see the informational message again before answering the input 
prompt, enter “?” to review the material. 
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b. If you are not the owner of (or are not linked to) the production minidisk, 
the installation EXEC prompts you to determine whether to force a logoff of 
the user ID that owns the production minidisk. If you enter “1” or “YES”, 
the installation exec forces off that user ID (if it is currently running 
disconnected in the system). 


After the installation EXEC has applied service for the PUT tape, it will 
automatically invoke the installation verification procedure (IVP) to verify the 
service installation. You will be given a message which states whether the IVP 
completed successfully or not. See the Program Directory for a similar example of 
the IVP output. 


When all the VS Pascal service has been applied, VMSERV will apply service for 
the remaining products on the tape or allow you to exit. 


Output from Applying VS Pascal Service: Figure 9 shows the output from installing 
a PUT. The lines beginning with ===> indicate what you entered. 


===> [5668767 PUT 
*** Begin VS Pascal Maintenance Procedure *** 
Version 1 Release 2.0 


This procedure will type out messages and request responses 
from you to guide the maintenance process. If at any time 

you want to quit, type "QUIT" as a response, and the procedure 
will terminate immediately. If you need to see the information 
message again before answering the input prompt, enter "?" to 
re-view the material. 


nee The product minidisk will be linked using the following 
ane default values: 


KKK 


+<e* Userid = (your userid) 

aes Minidisk address = <cuu> 

ane Password = (link password of the production minidisk) 
KKK 

See Do you want to change any of the above parameters? 
vEX Enter 1 (YES) or 60 (NO). 

==<s> l 


*** Enter userid (or NULL for existing value): 

===> 

*** Enter minidisk address (or NULL for existing value): 
===> 192 

*** Enter password (or NULL for existing value): 


===> 


*** Servicing VS Pascal (5668-767) ... 


*** Moving product files from temporary work disk to product disk ... 


( The output from the installation verification procedure is ) 
( displayed here. See the Program Directory for an example of ) 
( the correct output. ) 


kkk VS Pascal HH KAKHKHKHK KKK IKKE HK EKA EKER EKER KEKE KIRKE KAKA 


saa Product maintenance is complete. 
KIKKIKAKKEKHAKE KEK KIA K KK KK ERE EKER EREREREEEKEIERE REE KEKE KERR ERK 


Figure 9. Output from Installing a PUT 
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